home *** CD-ROM | disk | FTP | other *** search
/ Programming Sound Cards / Programming Sound Cards.iso / sound_54 / rttytest.doc < prev    next >
Text File  |  1995-01-01  |  4KB  |  89 lines
  1.  
  2.  
  3.                                 RTTY TEST LIBRARY
  4.                                 =================
  5.  
  6.                      Copyright 1990 by Power Mountain Systems
  7.                          P.O. Box 161, Cora, Wyoming 82925
  8.                                  (307) 367-4766
  9.  
  10.                             Registration fee is $20.00
  11.  
  12.  
  13.         This library is for Quick C programmers, and allows you direct control
  14. of the sound generator in your PC.  With these utilities it is possible to
  15. generate tones that are accurate and completely seamless.  No lttle gaps in
  16. between each frequency change.
  17.         Those who register will also receive other routines as well as those
  18. included here, along with improvements made.  Added routines will include CW
  19. (Morse) utilities and other little goodies.  If you like these routines then
  20. registering would be to your advantage, not just an ethical responsibility.
  21.         This library is SHAREWARE and using it without paying for it is
  22. stealing.
  23.         If you have any suggestions then we would love to here from you.  If
  24. we can help please call or write.
  25.  
  26.         This library can be merged into your Large memory model library with the
  27. LIB utility.  The command looks like this:
  28.  
  29.                           LIB LLIBCE +RTTYTEST.LIB;
  30.  
  31.  
  32.        RTTYTEST.EXE is a program written to help in the building and calibration
  33. of the PMX-200 Morse/RTTY Detector project featured in the APRIL/MAY 1990 issues
  34. of Radio Electronics.  This program demonstrates the feasability of this library
  35. of routines.  RTTYTEST.EXE will be revised often over the next couple of months
  36. and become more refined then it is here.  An updated version will be included to
  37. those who register.
  38.        RTTYTEST.CFG is the delay factor (993) that works with my system here,
  39. and when you choose option 'X' the program will recalculate the proper value for
  40. your system.  The higher the number the faster your machine is.
  41.        TESTRYRY.DAT is a text file that you can edit to suit your needs with
  42. a normal programmer's editor, EDLIN, etc.  It should contain the message you
  43. want to use to test your system.
  44.  
  45.  
  46. Here are a few of the features in this library:
  47.  
  48.         rttyon(mark);
  49.  
  50.         This routine starts the sound generator and leaves it running at the
  51. desired frequency.  'mark' is the desired frequency in hertz.
  52.  
  53.         rttyoff();
  54.  
  55.         This little gem turns off the tone currently running.
  56.  
  57.         movemark(freq);
  58.  
  59.         This allows you to change frequency without reinitializing the sound
  60. generator ic.  The big reason that a glitch is generated in the audio when you
  61. try to generate the sound with a normal high level language procedure is the
  62. internal initialization in the chip itself.  Using movemark(); we can change
  63. the frequency without tampering with any other parameter.  Smooth as silk and
  64. blinding fast in assembler.  'freq' is the new desired frequency in hertz.
  65.         The frequency sweeping done in rttytest.exe was done with this
  66. procedure and though it is sweeping 10 hertz at time the change sounds smooth
  67. and allows you to use a scope to sweep the input filters to check their
  68. frequency response.  VERY handy.
  69.  
  70.         sound(freq,duration,delay);
  71.  
  72.         SOUND was developed because QuickC 2.0 lacks a speaker beeper, and I
  73. wanted to have one.  'freq' is the frequency in hertz, duration is the length
  74. in milliseconds (65535 max) and delay is an integer that is the loop timing for
  75. the specific system you're on.  On this 12 Mhz AT 993 is the delay integer that
  76. calibrates 'duration' for 1 millisecond intervals.  On an old Tandy 1000 the
  77. number Is 263.  You can use rttytest.exe to determine the correct delay number.
  78. Just run it and option number 'X'.  It'll give you the correct value.
  79.  
  80.         rttysend(char,mark,bit,shift,delay);
  81.  
  82.         RTTYSEND has a complete assembly coded ascii to baudot translator built
  83. in to allow easy and perfect baudot transmission.  All you do pass the pertinent
  84. information to the routine and it does the rest.  'char' is an integer value
  85. that corresponds to the letter value.  'mark' is the mark frequency in hertz.
  86. 'bit' is the bit length in milliseconds.  'shift' is the shift in frequency
  87. required, and delay is described above, under sound();
  88.  
  89.